home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XrmMergeDatabases.z / XrmMergeDatabases
Encoding:
Text File  |  1998-10-30  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXrrrrmmmmMMMMeeeerrrrggggeeeeDDDDaaaattttaaaabbbbaaaasssseeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXrrrrmmmmMMMMeeeerrrrggggeeeeDDDDaaaattttaaaabbbbaaaasssseeeessss((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XrmMergeDatabases, XrmCombineDatabase,
  10.           XrmCombineFileDatabase - merge resource databases
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           void XrmMergeDatabases(_s_o_u_r_c_e__d_b, _t_a_r_g_e_t__d_b)
  14.                 XrmDatabase _s_o_u_r_c_e__d_b, *_t_a_r_g_e_t__d_b;
  15.  
  16.           void XrmCombineDatabase(_s_o_u_r_c_e__d_b, _t_a_r_g_e_t__d_b, _o_v_e_r_r_i_d_e)
  17.                 XrmDatabase _s_o_u_r_c_e__d_b, *_t_a_r_g_e_t__d_b;
  18.                 Bool _o_v_e_r_r_i_d_e;
  19.  
  20.           Status XrmCombineFileDatabase(_f_i_l_e_n_a_m_e, _t_a_r_g_e_t__d_b, _o_v_e_r_r_i_d_e)
  21.                 char *_f_i_l_e_n_a_m_e;
  22.                 XrmDatabase *_t_a_r_g_e_t__d_b;
  23.                 Bool _o_v_e_r_r_i_d_e;
  24.  
  25.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  26.           _s_o_u_r_c_e__d_b Specifies the resource database that is to be
  27.                     merged into the target database.
  28.  
  29.           _t_a_r_g_e_t__d_b Specifies the resource database into which the
  30.                     source database is to be merged.
  31.  
  32.           _f_i_l_e_n_a_m_e  Specifies the resource database file name.
  33.  
  34.           _o_v_e_r_r_i_d_e  Specifies whether source entries override target
  35.                     ones.
  36.  
  37.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.           Calling the _X_r_m_M_e_r_g_e_D_a_t_a_b_a_s_e_s function is equivalent to
  39.           calling the _X_r_m_C_o_m_b_i_n_e_D_a_t_a_b_a_s_e function with an override
  40.           argument of _T_r_u_e.
  41.  
  42.           The _X_r_m_C_o_m_b_i_n_e_D_a_t_a_b_a_s_e function merges the contents of one
  43.           database into another.  If the same specifier is used for an
  44.           entry in both databases, the entry in the source_db will
  45.           replace the entry in the target_db if override is _T_r_u_e;
  46.           otherwise, the entry in source_db is discarded.  If
  47.           target_db contains NULL, _X_r_m_C_o_m_b_i_n_e_D_a_t_a_b_a_s_e simply stores
  48.           source_db in it.  Otherwise, source_db is destroyed by the
  49.           merge, but the database pointed to by target_db is not
  50.           destroyed.  The database entries are merged without changing
  51.           values or types, regardless of the locales of the databases.
  52.           The locale of the target database is not modified.
  53.  
  54.           The _X_r_m_C_o_m_b_i_n_e_F_i_l_e_D_a_t_a_b_a_s_e function merges the contents of a
  55.           resource file into a database.  If the same specifier is
  56.           used for an entry in both the file and the database, the
  57.           entry in the file will replace the entry in the database if
  58.           override is _T_r_u_e; otherwise, the entry in the file is
  59.           discarded.  The file is parsed in the current locale.  If
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXrrrrmmmmMMMMeeeerrrrggggeeeeDDDDaaaattttaaaabbbbaaaasssseeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXrrrrmmmmMMMMeeeerrrrggggeeeeDDDDaaaattttaaaabbbbaaaasssseeeessss((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           the file cannot be read, a zero status is returned;
  75.           otherwise, a nonzero status is returned.  If target_db
  76.           contains NULL, _X_r_m_C_o_m_b_i_n_e_F_i_l_e_D_a_t_a_b_a_s_e creates and returns a
  77.           new database to it.  Otherwise, the database pointed to by
  78.           target_db is not destroyed by the merge.  The database
  79.           entries are merged without changing values or types,
  80.           regardless of the locale of the database.  The locale of the
  81.           target database is not modified.
  82.  
  83.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.           XrmGetResource(3X11), XrmInitialize(3X11),
  85.           XrmPutResource(3X11)
  86.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.